detail: z
          .enum(['summary', 'standard', 'full'])
          .optional()
          .default('standard')
          .describe(
            'Response verbosity. "summary": name, scores, and stop signal only. "standard"/"full": full violations and per-test-case results (default).'
          ),
        baseline_run_id: z
          .string()
          .optional()
          .describe(
            'run_id from a previous call. When provided, returns only violations that are new or resolved since that run: { added, resolved, unchanged_count, run_id }. If not found, returns error BASELINE_NOT_FOUND.'
          ),
      },

        detail: z
          .enum(['summary', 'standard', 'full'])
          .optional()
          .default('standard')
          .describe(
            'Response verbosity. "summary": is_valid, scores, and stop signal only. "standard"/"full": full issues list (default).'
          ),
        baseline_run_id: z
          .string()
          .optional()
          .describe(
            'run_id from a previous call. When provided, returns only issues that are new or resolved since that run: { added, resolved, unchanged_count, run_id }. If not found, returns error BASELINE_NOT_FOUND.'
          ),
      },
    },

        detail: z
          .enum(['summary', 'standard', 'full'])
          .optional()
          .default('standard')
          .describe(
            'Response verbosity. "summary": name, scores, and stop signal only. "standard"/"full": full violations and hierarchy results (default).'
          ),
      },
    },
    ({ plan_name, test_suites, test_cases, test_suite_count, metadata, quality_threshold, detail }) => {
      const requestId = makeRequestId();
      log('info', 'provar_testplan_validate', { requestId, plan_name });

      try {
        const threshold = quality_threshold ?? 80;
        const input: TestPlanInput = {
          name: plan_name,
          test_suites: test_suites ?? [],
          test_cases: test_cases ?? [],
          test_suite_count,
          metadata: metadata ?? {},
        };

        const result = validatePlan(input, threshold);
        const summary = buildHierarchySummary(result);

        const completeness_score = calcCompletenessScore(summary.test_cases_valid, summary.total_test_cases);
        const recommended_next_action = calcNextAction(completeness_score, false);

        const response = {
          requestId,
          completeness_score,
          recommended_next_action,
          ...result,
          summary,
        };

        const detailLevel = (detail ?? 'standard') as DetailLevel;
        const finalResponse = applyDetailLevel(response, detailLevel, PLAN_VALIDATE_SUMMARY_FIELDS);

        return {
          content: [{ type: 'text' as const, text: JSON.stringify(finalResponse) }],
          structuredContent: finalResponse,
        };

function suiteStorageDir(): string {
  return path.join(os.homedir(), '.provardx', 'validation');
}

/** Storage dir for testcase diff runs (home-based, shared across projects). */
function tcStorageDir(): string {
  return path.join(os.homedir(), '.provardx', 'validation');
}